NAME¶

logwatch - system log analyzer and reporter

SYNOPSIS¶

logwatch [--detail level ] [--logfile log-file-group ] [--service service-name ] [--print] [--mailto address ] [--archives] [--range range ] [--debug level ] [--save file-name ] [--logdir directory ] [--hostname hostname ] [--splithosts] [--multiemail] [--output output-type ] [--numeric] [--no-oldfiles-log] [--version] [--help|--usage]

DESCRIPTION¶

Logwatch is a customizable, pluggable log-monitoring system. It will go through your logs for a given period of time and make a report in the areas that you wish with the detail that you wish. Logwatch is being used for Linux and many types of UNIX.

OPTIONS¶

--detail level

This is the detail level of the report. level can be a positive integer, or high, med, low, which correspond to the integers 10, 5, and 0, repectively.

--logfile log-file-group

This will force Logwatch to process only the set of logfiles defined by log-file-group (i.e. messages, xferlog, ...). Logwatch will therefore process all services that use those logfiles. This option can be specified more than once to specify multiple logfile-groups.

--service service-name

This will force Logwatch to process only the service specified in service-name (i.e. login, pam, identd, ...). Logwatch will therefore also process any log-file-groups necessary to process these services. This option can be specified more than once to specify multiple services to process. A useful service-name is All which will process all services (and logfile-groups) for which you have filters installed.

--print

Print the results to stdout (i.e. the screen).

--mailto address

Mail the results to the email address or user specified in address. This option overrides the --print option.

--range range

You can specify a date-range to process. Common ranges are Yesterday, Today, All, and Help. Additional options are listed when invoked with the Help parameter.

--archives

Each log-file-group has basic logfiles (i.e. /var/log/messages) as well as archives (i.e. /var/log/messages.? or /var/log/messages.?.gz). When used with "--range all", this option will make Logwatch search through the archives in addition to the regular logfiles. For other values of --range, Logwatch will search the appropriate archived logs.

--debug level

For debugging purposes. level can range from 0 to 100. This will really clutter up your output. You probably don't want to use this.

--save file-name

Save the output to file-name instead of displaying or mailing it.

--logdir directory

Look in directory for log subdirectories or log files instead of the default directory.

--hostname hostname

Use hostname for the reports instead of this system's hostname. In addition, if HostLimit is set in the logwatch.conf configuration file (see MORE INFORMATION, below), then only logs from this hostname will be processed (where appropriate).

--numeric

Inhibits additional name lookups, displaying IP addresses numerically.

--no-oldfiles-log

Suppress the logwatch log, which informs about the old files in logwatch tmpdir.

--help

Displays usage information.

FILES¶

/usr/share/logwatch/

/etc/logwatch

EXAMPLES¶

logwatch --service ftpd-xferlog --range all --detail high --print --archives

MORE INFORMATION¶

The directory /usr/share/doc/logwatch-* contains several files with additional documentation:
HOWTO-Customize-LogWatch

AUTHOR¶

Kirk Bauer <kirk@kaybee.org>
http://www.kaybee.org/~kirk
ftp://ftp.kaybee.org/pub/redhat/RPMS